Azure OpenAI (preview:2024-02-15)

2025/02/20 • 4 updated methods

ListAssistants (updated)
Description :  Gets a list of assistants that were previously created.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ListAssistants",
  "$parameters": [
    {
      "#name": "before",
      "Description": {
        "new": "A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.",
        "old": "A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list."
      }
    }
  ]
}

⚼ Request

GET:  /assistants
{
limit:
{
Description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20. ,
Format: int32 ,
Required: False ,
}
integer ,
order:
{
Description: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. ,
Required: False ,
}
string ,
after:
{
Description: A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list. ,
Required: False ,
}
string ,
before:
{
Description: A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
object:
{
Description: The object type, which is always list. ,
Enum:
{
list: No description available. ,
}
,
Required: True ,
}
enum ,
data:
{
Description: The requested list of items. ,
Required: True ,
}
[
{
id:
{
Description: The identifier, which can be referenced in API endpoints. ,
Required: True ,
}
string ,
object:
{
Description: The object type, which is always assistant. ,
Enum:
{
assistant: No description available. ,
}
,
Required: True ,
}
enum ,
created_at:
{
Description: The Unix timestamp, in seconds, representing when this object was created. ,
Format: unixtime ,
Required: True ,
}
integer ,
name:
{
Description: The name of the assistant. ,
Required: True ,
}
string ,
description:
{
Description: The description of the assistant. ,
Required: True ,
}
string ,
model:
{
Description: The ID of the model to use. ,
Required: True ,
}
string ,
instructions:
{
Description: The system instructions for the assistant to use. ,
Required: True ,
}
string ,
tools:
{
Description: The collection of tools enabled for the assistant. ,
Required: True ,
}
[
{
type:
{
Description: The object type. ,
Required: True ,
}
string ,
}
,
]
,
metadata:
{
Description: A set of up to 16 key/value pairs that can be attached to an object, used for storing additional information about that object in a structured format. Keys may be up to 64 characters in length and values may be up to 512 characters in length. ,
Required: True ,
}
object ,
}
,
]
,
first_id:
{
Description: The first ID represented in this list. ,
Required: True ,
}
string ,
last_id:
{
Description: The last ID represented in this list. ,
Required: True ,
}
string ,
has_more:
{
Description: A value indicating whether there are additional values available not captured in this list. ,
Required: True ,
}
boolean ,
}
ListMessages (updated)
Description :  Gets a list of messages that exist on a thread.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ListMessages",
  "$parameters": [
    {
      "#name": "before",
      "Description": {
        "new": "A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.",
        "old": "A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list."
      }
    }
  ]
}

⚼ Request

GET:  /threads/{threadId}/messages
{
threadId:
{
Description: The ID of the thread to list messages from. ,
Required: True ,
}
string ,
limit:
{
Description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20. ,
Format: int32 ,
Required: False ,
}
integer ,
order:
{
Description: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. ,
Required: False ,
}
string ,
after:
{
Description: A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list. ,
Required: False ,
}
string ,
before:
{
Description: A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
object:
{
Description: The object type, which is always list. ,
Enum:
{
list: No description available. ,
}
,
Required: True ,
}
enum ,
data:
{
Description: The requested list of items. ,
Required: True ,
}
[
{
id:
{
Description: The identifier, which can be referenced in API endpoints. ,
Required: True ,
}
string ,
object:
{
Description: The object type, which is always 'thread.message'. ,
Enum:
{
thread.message: No description available. ,
}
,
Required: True ,
}
enum ,
created_at:
{
Description: The Unix timestamp, in seconds, representing when this object was created. ,
Format: unixtime ,
Required: True ,
}
integer ,
thread_id:
{
Description: The ID of the thread that this message belongs to. ,
Required: True ,
}
string ,
status:
{
Description: The status of the message. ,
Enum:
{
in_progress: A run is currently creating this message. ,
incomplete: This message is incomplete. See incomplete_details for more information. ,
completed: This message was successfully completed by a run. ,
}
,
Required: True ,
}
enum ,
incomplete_details:
{
Description: On an incomplete message, details about why the message is incomplete. ,
Required: True ,
}
object ,
completed_at:
{
Description: The Unix timestamp (in seconds) for when the message was completed. ,
Format: unixtime ,
Required: True ,
}
integer ,
incomplete_at:
{
Description: The Unix timestamp (in seconds) for when the message was marked as incomplete. ,
Format: unixtime ,
Required: True ,
}
integer ,
role:
{
Description: The role associated with the assistant thread message. ,
Enum:
{
user: The role representing the end-user. ,
assistant: The role representing the assistant. ,
}
,
Required: True ,
}
enum ,
content:
{
Description: The list of content items associated with the assistant thread message. ,
Required: True ,
}
[
{
type:
{
Description: The object type. ,
Required: True ,
}
string ,
}
,
]
,
assistant_id:
{
Description: If applicable, the ID of the assistant that authored this message. ,
Required: True ,
}
string ,
run_id:
{
Description: If applicable, the ID of the run associated with the authoring of this message. ,
Required: True ,
}
string ,
metadata:
{
Description: A set of up to 16 key/value pairs that can be attached to an object, used for storing additional information about that object in a structured format. Keys may be up to 64 characters in length and values may be up to 512 characters in length. ,
Required: True ,
}
object ,
}
,
]
,
first_id:
{
Description: The first ID represented in this list. ,
Required: True ,
}
string ,
last_id:
{
Description: The last ID represented in this list. ,
Required: True ,
}
string ,
has_more:
{
Description: A value indicating whether there are additional values available not captured in this list. ,
Required: True ,
}
boolean ,
}
ListRuns (updated)
Description :  Gets a list of runs for a specified thread.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ListRuns",
  "$parameters": [
    {
      "#name": "before",
      "Description": {
        "new": "A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.",
        "old": "A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list."
      }
    }
  ]
}

⚼ Request

GET:  /threads/{threadId}/runs
{
threadId:
{
Description: The ID of the thread to list runs from. ,
Required: True ,
}
string ,
limit:
{
Description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20. ,
Format: int32 ,
Required: False ,
}
integer ,
order:
{
Description: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. ,
Required: False ,
}
string ,
after:
{
Description: A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list. ,
Required: False ,
}
string ,
before:
{
Description: A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
object:
{
Description: The object type, which is always list. ,
Enum:
{
list: No description available. ,
}
,
Required: True ,
}
enum ,
data:
{
Description: The requested list of items. ,
Required: True ,
}
[
{
id:
{
Description: The identifier, which can be referenced in API endpoints. ,
Required: True ,
}
string ,
object:
{
Description: The object type, which is always 'thread.run'. ,
Enum:
{
thread.run: No description available. ,
}
,
Required: True ,
}
enum ,
thread_id:
{
Description: The ID of the thread associated with this run. ,
Required: True ,
}
string ,
assistant_id:
{
Description: The ID of the assistant associated with the thread this run was performed against. ,
Required: True ,
}
string ,
status:
{
Description: The status of the assistant thread run. ,
Enum:
{
queued: Represents a run that is queued to start. ,
in_progress: Represents a run that is in progress. ,
requires_action: Represents a run that needs another operation, such as tool output submission, to continue. ,
cancelling: Represents a run that is in the process of cancellation. ,
cancelled: Represents a run that has been cancelled. ,
failed: Represents a run that failed. ,
completed: Represents a run that successfully completed. ,
expired: Represents a run that expired before it could otherwise finish. ,
}
,
Required: True ,
}
enum ,
required_action:
{
Description: The details of the action required for the assistant thread run to continue. ,
Required: False ,
}
object ,
last_error:
{
Description: The last error, if any, encountered by this assistant thread run. ,
Required: True ,
}
object ,
model:
{
Description: The ID of the model to use. ,
Required: True ,
}
string ,
instructions:
{
Description: The overridden system instructions used for this assistant thread run. ,
Required: True ,
}
string ,
tools:
{
Description: The overridden enabled tools used for this assistant thread run. ,
Required: True ,
}
[
{
type:
{
Description: The object type. ,
Required: True ,
}
string ,
}
,
]
,
created_at:
{
Description: The Unix timestamp, in seconds, representing when this object was created. ,
Format: unixtime ,
Required: True ,
}
integer ,
expires_at:
{
Description: The Unix timestamp, in seconds, representing when this item expires. ,
Format: unixtime ,
Required: True ,
}
integer ,
started_at:
{
Description: The Unix timestamp, in seconds, representing when this item was started. ,
Format: unixtime ,
Required: True ,
}
integer ,
completed_at:
{
Description: The Unix timestamp, in seconds, representing when this completed. ,
Format: unixtime ,
Required: True ,
}
integer ,
cancelled_at:
{
Description: The Unix timestamp, in seconds, representing when this was cancelled. ,
Format: unixtime ,
Required: True ,
}
integer ,
failed_at:
{
Description: The Unix timestamp, in seconds, representing when this failed. ,
Format: unixtime ,
Required: True ,
}
integer ,
incomplete_details:
{
Description: Details on why the run is incomplete. Will be `null` if the run is not incomplete. ,
Enum:
{
max_completion_tokens: Maximum completion tokens exceeded ,
max_prompt_tokens: Maximum prompt tokens exceeded ,
}
,
Required: True ,
}
enum ,
usage:
{
Description: Usage statistics related to the run. This value will be `null` if the run is not in a terminal state (i.e. `in_progress`, `queued`, etc.). ,
Required: True ,
}
object ,
metadata:
{
Description: A set of up to 16 key/value pairs that can be attached to an object, used for storing additional information about that object in a structured format. Keys may be up to 64 characters in length and values may be up to 512 characters in length. ,
Required: True ,
}
object ,
}
,
]
,
first_id:
{
Description: The first ID represented in this list. ,
Required: True ,
}
string ,
last_id:
{
Description: The last ID represented in this list. ,
Required: True ,
}
string ,
has_more:
{
Description: A value indicating whether there are additional values available not captured in this list. ,
Required: True ,
}
boolean ,
}
ListRunSteps (updated)
Description :  Gets a list of run steps from a thread run.
Reference :  Link ¶

⚶ Changes

{
  "#id": "ListRunSteps",
  "$parameters": [
    {
      "#name": "before",
      "Description": {
        "new": "A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list.",
        "old": "A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list."
      }
    }
  ]
}

⚼ Request

GET:  /threads/{threadId}/runs/{runId}/steps
{
threadId:
{
Description: The ID of the thread that was run. ,
Required: True ,
}
string ,
runId:
{
Description: The ID of the run to list steps from. ,
Required: True ,
}
string ,
limit:
{
Description: A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 20. ,
Format: int32 ,
Required: False ,
}
integer ,
order:
{
Description: Sort order by the created_at timestamp of the objects. asc for ascending order and desc for descending order. ,
Required: False ,
}
string ,
after:
{
Description: A cursor for use in pagination. after is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with obj_foo, your subsequent call can include after=obj_foo in order to fetch the next page of the list. ,
Required: False ,
}
string ,
before:
{
Description: A cursor for use in pagination. before is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with obj_foo, your subsequent call can include before=obj_foo in order to fetch the previous page of the list. ,
Required: False ,
}
string ,
}

⚐ Response (200)

{
object:
{
Description: The object type, which is always list. ,
Enum:
{
list: No description available. ,
}
,
Required: True ,
}
enum ,
data:
{
Description: The requested list of items. ,
Required: True ,
}
[
{
id:
{
Description: The identifier, which can be referenced in API endpoints. ,
Required: True ,
}
string ,
object:
{
Description: The object type, which is always 'thread.run.step'. ,
Enum:
{
thread.run.step: No description available. ,
}
,
Required: True ,
}
enum ,
type:
{
Description: The type of run step, which can be either message_creation or tool_calls. ,
Enum:
{
message_creation: Represents a run step to create a message. ,
tool_calls: Represents a run step that calls tools. ,
}
,
Required: True ,
}
enum ,
assistant_id:
{
Description: The ID of the assistant associated with the run step. ,
Required: True ,
}
string ,
thread_id:
{
Description: The ID of the thread that was run. ,
Required: True ,
}
string ,
run_id:
{
Description: The ID of the run that this run step is a part of. ,
Required: True ,
}
string ,
status:
{
Description: The status of this run step. ,
Enum:
{
in_progress: Represents a run step still in progress. ,
cancelled: Represents a run step that was cancelled. ,
failed: Represents a run step that failed. ,
completed: Represents a run step that successfully completed. ,
expired: Represents a run step that expired before otherwise finishing. ,
}
,
Required: True ,
}
enum ,
step_details:
{
Description: The details for this run step. ,
Required: True ,
}
{
type:
{
Description: The object type. ,
Enum:
{
message_creation: Represents a run step to create a message. ,
tool_calls: Represents a run step that calls tools. ,
}
,
Required: True ,
}
enum ,
}
,
last_error:
{
Description: If applicable, information about the last error encountered by this run step. ,
Required: True ,
}
object ,
created_at:
{
Description: The Unix timestamp, in seconds, representing when this object was created. ,
Format: unixtime ,
Required: True ,
}
integer ,
expired_at:
{
Description: The Unix timestamp, in seconds, representing when this item expired. ,
Format: unixtime ,
Required: True ,
}
integer ,
completed_at:
{
Description: The Unix timestamp, in seconds, representing when this completed. ,
Format: unixtime ,
Required: True ,
}
integer ,
cancelled_at:
{
Description: The Unix timestamp, in seconds, representing when this was cancelled. ,
Format: unixtime ,
Required: True ,
}
integer ,
failed_at:
{
Description: The Unix timestamp, in seconds, representing when this failed. ,
Format: unixtime ,
Required: True ,
}
integer ,
usage:
{
Description: Usage statistics related to the run step. This value will be `null` while the run step's status is `in_progress`. ,
Required: False ,
}
object ,
metadata:
{
Description: A set of up to 16 key/value pairs that can be attached to an object, used for storing additional information about that object in a structured format. Keys may be up to 64 characters in length and values may be up to 512 characters in length. ,
Required: True ,
}
object ,
}
,
]
,
first_id:
{
Description: The first ID represented in this list. ,
Required: True ,
}
string ,
last_id:
{
Description: The last ID represented in this list. ,
Required: True ,
}
string ,
has_more:
{
Description: A value indicating whether there are additional values available not captured in this list. ,
Required: True ,
}
boolean ,
}